Skip to content

chore(release): Upgrade self-hosted Weaviate to 1.38 and weaviate-client to 4.22#38214

Draft
dudanogueira wants to merge 2 commits into
langgenius:mainfrom
dudanogueira:feat/weaviate-1.38-upgrade
Draft

chore(release): Upgrade self-hosted Weaviate to 1.38 and weaviate-client to 4.22#38214
dudanogueira wants to merge 2 commits into
langgenius:mainfrom
dudanogueira:feat/weaviate-1.38-upgrade

Conversation

@dudanogueira

@dudanogueira dudanogueira commented Jun 30, 2026

Copy link
Copy Markdown

Summary

Upgrades the bundled self-hosted Weaviate from 1.27.0 to 1.38.1 and the weaviate-client dependency from 4.20.5 to 4.22.0. Pure version bump + env-example consistency; no behavior change to the VDB code path.

  • Bump image to cr.weaviate.io/semitechnologies/weaviate:1.38.1 in docker/docker-compose.yaml, docker/docker-compose.middleware.yaml, and docker/docker-compose-template.yaml.
  • Bump weaviate-client 4.20.5 → 4.22.0 in api/providers/vdb/vdb-weaviate/pyproject.toml (+ uv.lock).
  • Add the missing WEAVIATE_GRPC_ENDPOINT / EXPOSE_WEAVIATE_GRPC_PORT entries to api/.env.example, the integration-test env, and middleware.env.example.

Fixes #38211

Screenshots

Before After
N/A — backend / deployment config only (no UI) N/A

Checklist

  • This change requires a documentation update, included: Dify Document
  • I understand that this PR may be closed in case there was no previous discussion or issues. (This doesn't apply to typos!)
  • I've added a test for each change that was introduced, and I tried as much as possible to make a single atomic change.
  • I've updated the documentation accordingly.
  • I ran make lint && make type-check (backend) — both pass. Frontend pnpm exec vp staged N/A (no frontend changes).

From Claude Code

- Bump image to cr.weaviate.io/semitechnologies/weaviate:1.38.1 across
  docker-compose.yaml, docker-compose.middleware.yaml, and the template
- Bump weaviate-client 4.20.5 -> 4.22.0 (vdb-weaviate package + uv.lock)
- Add missing WEAVIATE_GRPC_ENDPOINT / EXPOSE_WEAVIATE_GRPC_PORT entries to
  api/.env.example, integration test env, and middleware.env.example
@dudanogueira dudanogueira requested a review from a team June 30, 2026 10:04
@dosubot dosubot Bot added size:XS This PR changes 0-9 lines, ignoring generated files. dependencies Pull requests that update a dependency file labels Jun 30, 2026
@41tair 41tair changed the title Upgrade self-hosted Weaviate to 1.38 and weaviate-client to 4.22 chore(release): Upgrade self-hosted Weaviate to 1.38 and weaviate-client to 4.22 Jul 1, 2026
@41tair

41tair commented Jul 1, 2026

Copy link
Copy Markdown
Member

Hi, thanks for your contribution! Would you like to add some migration docs to docs ? Since this upgrade spans multiple versions, I think having a migration guide is necessary.

@dudanogueira

Copy link
Copy Markdown
Author

hi there! Sure thing. I will still run some tests, but I do not expect and breaking change. We advise to no jump versions. For 1.27 -> 1.27.latest -> 1.28.latest -> etc etc

I will mark it as draft while I work on those tests.

Also, I am working on exposing some other options, such as compression, different index options and multi tenant support. This can help reducing resource consumption and large scale scenarios. Also, an integration for memory with our recently launched memory layer.

Thanks!

@dudanogueira dudanogueira marked this pull request as draft July 2, 2026 03:13
Register the X-Weaviate-Client-Integration header (value: dify/<version>)
on the Weaviate client so the server can attribute traffic to Dify in its
telemetry, alongside the built-in X-Weaviate-Client header. This mirrors the
approach used by other official Weaviate integrations.

The version is resolved from dify_config.project.version, falling back to the
dify-api package metadata and then "unknown". Registration is best-effort and
wrapped in try/except so it never breaks client initialization on older
weaviate-client releases that lack the integrations API.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file size:XS This PR changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Upgrade self-hosted Weaviate to 1.38 and weaviate-client to 4.22

2 participants